answer folder
Type
command
Summary
Displays a standard file dialog for the user to choose a folder.
Syntax
answer folder <prompt> [with <defaultPath>] [titled <windowTitle>] [as sheet]
Description
Use the answer folder command when you want the user to choose a folder --for example, as a destination for exported files.
If the as sheet form is used, the dialog box appears as a sheet on OS X systems. On other systems, the as sheet form has no effect and the dialog box appears normally. Attempting to open a sheet from within another sheet displays the second stack as a modal dialog box instead. To give a dialog box a prompt when using the as sheet form a non-empty title must be provided. This will cause the prompt to appear in the same place it would if as sheet was not being used.
If the systemFileSelector property is set to false, LiveCode's built-in dialog box is used instead of the operating system's standard file dialog.
Parameters
Name | Type | Description |
---|---|---|
prompt | string | If you specify empty, no prompt appears. |
defaultPath | The name and location of the folder whose contents are listed when the dialog box appears. If no defaultPath is specified, the dialog box lists the contents of the last folder you used with a file dialog box. | |
windowTitle | If specified, appears in the title bar of the dialog box. If no windowTitle is given, the title bar is blank. This parameter has no effect on macOS 10.11 (El Capitan) and above, so make sure that any important information is placed in the prompt parameter. |
Examples
answer folder "Please choose a folder:"
if it is empty then answer folder chooseMsg as sheet
answer folder "Where is the data?" with "../data_stacks/recent"
Related
command: answer file, revDeleteFolder
glossary: property, return, variable, modal dialog box, export, file dialog box, folder, command, dialog box
keyword: it
Compatibility and Support
Introduced
LiveCode 1.0
OS
mac
windows
linux
Platforms
desktop